  SMB3 Music Inserter
---------------------
2009/11/11 - beta 1.1
by JaSp
jaspile/hotmail/com

IPS patches instructions
========================

Select which IPS you need :

Reuben_new-music-format.ips	if you're using Reuben to edit your ROM
Apply it to a Reuben formated ROM; no expansion needed.

smb3exp_new-music-format.ips	if you're using any other editor, using SMB3 (PRG 1) ROM
/!\ SMB3 ROM MUST BE EXPANDED *BEFORE* APPLYING IPS PATCH
You can do this with smb3mi.exe, by selecting Project -> Expand ROM


How it works
------------
The patches will change the format of RAM address $4F5, used by the game to load songs.
The new format uses all 7 bits of the byte loaded to choose the song index and its
associated prg bank. Basically, this means that you can add up to about 189 new songs
of the same length as the original songs ! (7 * 27 songs)

A song will be shown as this in the utility :
"21 - Song Title"
The index shown before the title, here "21", is the actualy byte hex value to load at
$4F5 to play the song in the game.
This loading is handled differently wether you are using Reuben or not.

Reuben
------
Song selection is made via the new level header introduced in Reuben; you just need to
select the value from the utility into Reuben as the music of your level.

SMB3
----
I haven't found an easy and flexible enough way to load custom music into the game yet,
so you'll have to use Reuben instead.
Why is this provided then ? Well, you can use it to have a preview of the program's
capabilities : insert any song you want in the game, and then with a debugger such as
FCEUXD, change RAM address $4F5 via the hex editor to the song index showed in the song
list in smb3mi to play the new song.